Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Disabling Movies and Tracks

SetMovieActive

The SetMovieActive function allows your application to activate and deactivate a movie.

pascal void SetMovieActive (Movie theMovie, Boolean active);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

active

Activates or deactivates the movie. Set this parameter to true to activate the movie; set this parameter to false to deactivate the movie.

SPECIAL CONSIDERATIONS

The Movie Toolbox services only active movies. When you deactivate a movie, the Movie Toolbox may release system resources required by the movie, such as sound hardware, open files, and allocated memory. Unless you set the newMovieActive flag when creating a movie, you should call SetMovieActive before playing a movie.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can determine whether a movie is active by calling the GetMovieActive function, which is described in the next section.